¨
WINDOWSHADE X 4.0.2
a haxie by unsanity

What is WindowShade X?

WindowShade X provides an exciting and useful way of organizing your work on Mac OS X. With this handy tool, you can assign the following actions to the minimize button, double-click on the window title or any key combination:

	• Minimize the window to the Dock, like always;
	• Windowshade the window into a tiny strip to quickly peek below or get it out of the way;
	• Minimize-In-Place the window so it becomes really small yet you can see what happens inside and freely drag it around your screen;
	• Make the window transparent so you can continue working in it while seeing things under it;
	• Make window float on top so it will never be obscured by other windows;
	• Hide the application quickly;
	• Do nothing and ignore the action (sometimes it is quite useful).

These actions can be set on per-application basis so you can configure your workspace to be convenient for you - get more accomplished, and make it happen quicker!

Installing WindowShade X

To install, double-click the "WindowShade X Installer" icon and follow instructions on screen.

To uninstall, either:
	1) Double-click the "WindowShade X Installer" icon and click on "Uninstall" button (the installer will move all WindowShade X files to Trash - it will never actually delete any files on your system).
	2) Remove the file named "WindowShade X.prefPane" from the Library/PreferencePanes folder in your Home directory and the file "WindowShade X.ape"  from the Library/Application Enhancers folder in your Home directory.  If you installed for all users, you'll need to remove the above files from your main Library rather than your Home/Library directory.

Using WindowShade X

WindowShade X is very simple to use. All aspects of the haxie are controlled through its Preference Pane. To access the WindowShade X Preference Pane, choose "System Preferences" from the Apple menu and then select the WindowShade X icon. Below is the description of all options in the Preference Pane:

WindowShade X Tab

¨

	• WindowShade X Enabled: If this checkbox is selected, WindowShade X is active.

	• Help Button: this button will display the help document you are reading now.
	• Register Button: this button invokes the dialog where you can enter your registration information, go to the secure online purchase page, or retrieve lost registration code.
	• About Button: this button shows the about box containing credits and contact information for the haxie.

Settings Tab

¨

This section lets you edit default settings for WindowShade X and individual settings for applications you add. The six popups select the minimization style for each of the actions. Possible actions are (but not limited to):
        
	• Click the Minimize Button: this action is invoked when you click on the yellow minimize button of a window.
	• Double Click the Window Title Bar: this action is invoked when you double-click on the window's Title Bar.
	• Hold Control & Double Click the Window Title Bar: this action is invoked when you hold the Control key and double-click the window's Title Bar
	• Hold Command & Double Click the Window Title Bar: this action is invoked when you hold the Control key and double-click the window's Title Bar
	• Press Command (⌘): this action is invoked when you hold down the Command key and press M (if available in the particular application).
	• Press the Command (⌘) Key Twice: this action is invoked when you press the Command key twice in a row on the keyboard.
	• Press the Control (⌃) Key Twice: this action is invoked when you press the Control key twice in a row on the keyboard.

To disable a certain action, uncheck the checkbox near the action name.

Each action can be assigned a behavior:

	• WindowShade: when applied, only the window's Title Bar will be visible, à la Classic Mac OS.
	• Minimize-In-Place: when applied, the window will be minimized into a much smaller size allowing you to move it out of the way while still seeing it.
	• Make Window Transparent: when applied, the window will be partially transparent (you can specify the opacity using the Opacity slider found in the Advanced tab). You still can use the window as before when it is transparent.
	• Hide Application: when applied, the whole application will be hidden.
	• Make Window Float On Top: when applied, the window will float above all other windows.  You'll also notice it will get a small badge in the upper left to indicate it's floating status.
	• Minimize to Dock: this is the default Mac OS X behavior. The window will be sent to Dock using the Scale or Genie effect.
	• Do Nothing (Block System Defaults): when applied, this action will be ignored by the system (such as if you apply it to the Click the Minimize button action, subsequent clicks on the Minimize widget will make the system ignore them).

In addition, you can add arbitrary key combinations (such as F5 or Shift+F7) and assign different behaviors to it by clicking the Plus (+) button.

To add an arbitrary key combination, simply follow these steps:

1. Click the Plus (+) button to add a new Event/Action to invoke WindowShade X.

¨

2. Double click the text "Double click to assign a hot key shortcut" to ready WindowShade X to listen for the new keyboard shortcut.

¨

3. Press the keys for your new keyboard shortcut.  ( in this case, we pressed Apple-Shift-u )

¨

To remove an arbitrary keyboard shortcut, simply highlight the one you wish to remove and click the Minus (-) button.

Minimize-In-Place Tab

 ¨

This section lets you control settings for the new feature introduced in WindowShade X 3, Minimize-In-Place. Minimize-In-Place shrinks your window into a tiny size so you can move it out of the way while still seeing what's going on.
        
	• Minimized Window Size: This slider sets the size the minimized window will be.
	• Magnification: This checkbox and the slider control the minimized window magnification effect when you move the mouse cursor over the minimized window, similar to the same effect in the Dock. Note that if your Minimized Window Size is set to Maximum, the Magnification setting will have no effect.
	• Minimized Window Opacity: This slider sets the opacity level of the minimized window to suit your preferences. A live preview will be shown as you drag the slider around.
	• Minimized Windows Always Float On Top: If this checkbox is checked, the minimized windows will float above all of the other windows.
	• Single Click Maximizes Minimized Window: If this checkbox is checked, a single click in the minimized window will expand it; otherwise you'll have to do a double-click.
	• Show Animation When Window Is Minimized/Maximized: This checkbox enables or disables the animations when the windows are minimized and maximized.  You can choose between Fade and Scale.
	• Display Application Icon In The Minimized Window: This checkbox and a popup menu control the appearance and size of the application icon on the minimized window.
	• When Mouse Hovers Over Minimized Window, Show: This checkbox and a popup control whether the minimized windows should show the parent window title, the application name or both when the mouse cursor hovers over them.
	• Arrange Minimized Windows Along: This checkbox and two popups enable the automatic arrangement of the minimized windows along one of the screen edges. if you have multiple monitors setup, a new arrangement group will be created for each monitor.
	• Hide MIP Windows While In Exposé: This checkbox controls whether the minimized-in-place windows should be shown in Exposé mode.

Minimized-In-Place or MIPed windows can be moved around the screen by clicking on them and dragging to the desired location.

Advanced Tab

¨ 

The Advanced section options include:

	• Play Sounds: If this checkbox is selected, WindowShade X will play sounds on window minimization and expansion.
	• Play Sounds Through Xounds: If this checkbox is selected, WindowShade X will play its default sounds using the currently active XoundSet (only available if Xounds, another haxie by Unsanity, is installed on your system).
	• Attempt To Shade Custom Window Types (such as iTunes): If this checkbox is selected, WindowShade X will attempt to perform a WindowShade action on custom (non-standard) windows, such as iTunes, and some other applications that use custom shaped windows. The end result may look not too pretty, but if this is what you want, this option is for you.

The Custom Window Shadows section lets adjust various window shadows aspects, such as density, opacity, offsets, and so on. Any changes you made will be shown in a small special preview window that will automatically appear and disappear while you're adjusting values so you can visually see what the new settings will look like.

	• Enable Custom Window Shadows: If this checkbox is selected, the custom shadow settings below will be used for system windows.
	• Presets Popup Menu: This popup menu contains various shadow settings presets. Warning, selecting a preset will override any shadow settings you may have set.

There are two groups of identical controls, for active (frontmost) window, and for all inactive windows:

	• Shadow Spread: This slider controls the shadow spread - the less value it has, the more condensed the shadow will be.
	• Shadow Density: This slider controls the shadow density - the less value it has the less opaque the shadow will be.
	• Horizontal Offset: This slider controls horizontal location of the shadow relative to its window. Negative values move the shadow to the left, positive - to the right.
	• Vertical Offset: This slider controls vertical location of the shadow relative to its window. Negative values move the shadow up, positive - down.
	• Draw Window Border: This checkbox enables or disables drawing of a thin gray border around every window.
	• Reset Button: This button will reset the shadow values to Apple default values.

Exclude List Tab

¨

This section allows you to exclude certain applications from being affected by WindowShade X. The newly added or removed applications will be affected only after being relaunched.

Known Issues

	• "Hold Control and Double-Click in the Window Title Bar" minimization action is not working in iTunes v4.5 and beyond.
	• It is not recommended to use Minimize-in-Place in Yahoo! Messager.
	• WindowShade X will not function in QuickMail.

Version History

Version 4.0.2 (September 22, 2005)
	- This update is free for all registered users.
	- Fixed numerous issues with WindowShade X not working right with certain applications (Opera, Azureus, Eclipse, Mariner Write, Internet Explorer, and others).
	- Fixed a visual glitch with window shadows when custom shadows were enabled.
	- Other smaller bug fixes.

Version 4.0.1 (August  3, 2005)
	- This update is free for all registered users.
	- Fixed issues for users with Dutch or Traditional Chinese languages.
	- Removed a debug log entry in the Console. 

Version 4.0 (July 15, 2005)
	- This update is free for all registered users.
	- Now you are free to assign any hotkey combination to any action WindowShade X provides - no need to limit yourself to a set of pre-defined events! Choose Shift+F1 to make a front window transparent, Shift+F2 to minimize in place, and anything else your heart desires.
	- Minimized in place windows now properly update their titles if they change.
	- Float on top action now properly brings up the drawers of the window too.
	- Various adjustments in the preference pane interface.
	- Added a hidden option to enable logging to aid debugging.
	- Fixed a bug that could cause WindowShade X minimize in place feature to not work correctly under Mac OS X 10.4.
	- Other fixes and improvements through the code.
	- Spotlight search results window works with WindowShade X now.
	- Float-On-Top stalled icon bug fixed. 

Version 3.6 (April 28, 2005)
	- This version is compatible with Mac OS X 10.4 Tiger and Mac OS X 10.3 Panther.
	- Updated to include Application Enhancer 1.5.
	- Updated the installer.
	- Added Japanese localization by Akira Ikeda.

Version 3.5.2 (February 21, 2005)
	- Updated to include Application Enhancer 1.4.6.
	- Added Traditional Chinese localization by Jack M.H.Lin.
	- Added Dutch localization by Tom Klaver.
	- Fixed issues with WindowShade X not working or working incorrectly in Java-based applications (JBidWatcher, Parsnips, and others).
	- Fixed an issue when on fresh installs of Mac OS X 10.3 Application Enhancer would disable WindowShade X as not "Panther-certified".

Version 3.5.1 (December 6, 2004)
	- Updated to include Application Enhancer 1.4.5.
	- Various small fixes in the interface on the preference pane.
	- Small code fixes and tweaks.
	- Better support for localizations.

Version 3.5 (October 18, 2004)
	- This update is free for all registered users, as usual.
	- New "Make Window Float On Top" action to make certain windows permanently float on top of all others.
	- Added "Hide MIP Windows While in Exposé" option to manage how precisely you want your minimized-in-place windows to be displayed while in Exposé mode.
	- New icon and new interface.
	- Much better X11 integration.
	- Drawers are now affected by the "Set Transparent" affect, just like their parent windows.
	- Implemented new minimize-in-place animations: Fade and Scale. The Scale effect should be smoother now. Steve Mode (hold Shift for slow-mo) is in as well.
	- New serial number system.
	- Fixed a bug with WSX not respecting custom window shapes in Carbon apps (X-Lite, CustomWindow.app).
	- Worked around the bug in Mac OS X that may cause WindowServer to freeze during MIP animation transitions.
	- MIP windows now have a contextual menu which you can use to restore the window, or all windows in the application.
	- Fixed a bug with minimize-in-place windows losing its magnification state after the invocation of Exposé.
	- If WSX .ape module is missing in the proper directory (for example, disabled by the APE Manager), the preference pane will warn the user.
	- Much better drawers and sheets support for Carbon applications.
	- Improved implementation of "Double Command" and "Double Control" actions to prevent unwanted activations.
	- Better handling of floating but collapsible windows in the Cocoa applications while WindowShading.
	- Fixed a bug with conditions when Caps Lock key was pressed, "Command key pressed twice" and "Control key pressed twice" actions were not working.
	- Substantial amounts of other bug fixes and code re-factoring.

Version 3.1 (October 27, 2003)
	- Compatible with Mac OS X 10.3 Panther.
	- Japanese localization by Akira Ikeda.
	- Misc bug fixes and code tweaks.

Version 3.0.1 (September 18, 2003)
	- New actions to assign minimizations for: Command Key Pressed Twice and Control Key Pressed Twice allowing you to shade windows with your keyboard!
	- Window titles for Minimized-In-Place windows are now displayed below the MIP window if they would obscure the menu bar or go off the top screen edge.
	- Much better handling of smaller windows for minimizations (DragThing docks, for example).
	- Minimize-In-Place auto-alignment function now respects the Dock position and bounds.
	- Minimize-In-Place windows are being auto re-arranged when you expand one of the minimized windows.
	- Fixed a bug with Canvas™ 9 not being properly shading windows with WindowShade X.
	- Fixed an issue with QuarkXPress 6 disabling its menus if you Minimize-In-Place one of its document windows.
	- Fixed a bug with iChat still showing tooltips if the Buddy List window is minimized-in-place.
	- Fixed a bug with MYOB AccountEdge rendering tab controls inoperational when Control Center window is minimized-in-place.
	- Fixed a bug with iCab crashing if you click it's Dock icon when its window is MIPped.
	- Fixed a bug with drawer window reappearing on minimized windows if you have hidden and shown back the app with the minimized windows (Cocoa only).
	- Fixed an issue causing Classic Window Management by Robb Timlin not work in the Carbon applications.
	- Fixed a bug causing some Java applications to crash when expanding a minimized window (IntelliJ IDEA).
	- Fixed an issue with the Help button not working in the Preference Pane.

Version 3.0 (August 28, 2003)
	- This update is free for all registered users.
	- Introduced Minimize-In-Place functionality.
	- Minimized-In-Place windows can now be arranged along the screen edges.
	- Better support for multiple monitors.
	- WindowShade X now runs as a demo with no functions removed for 15 days instead of an hour per login.
	- Updated for Application Enhancer 1.3.
	- Various speed optimizations.
	- Bug fixes.

Version 3.0 Public Preview (June 18, 2003)
	- Introduced Minimize-In-Place functionality.
	- Updated for Application Enhancer 1.3.
	- Various speed optimizations.

Version 2.1.2 (January 28, 2003)
	- Rewrote the part for Cocoa applications from scratch.
	- Exclude list is enhanced so it is now possible to exclude Microsoft Office X applications, among others.
	- Updated with Application Enhancer 1.2.1.
	- Fixed the issues when minimizing the windows for X11 applications.
	- Fixed a bug causing an unattended drawer to hang on screen after minimizing to Dock a windowshaded window.
	- Fixed a bug with window expanding issues after disabling WindowShade X.
	- Fixed a bug with sounds not playing when doing all windows minimization.
	- Fixed a bug with sheets in Microsoft Word X (fix only works under Mac OS X 10.2).
	- Fixed a bug with disappearing rename field in the Finder (it still is present in different form, due to a bug in Finder itself).
	- Fixed a bug with Mail.app not being able to double-click a message after s minimizing of a main window.
	- Fixed a bug with Mail.app disabling certain menu items after minimizing of a main window.

Version 2.1.1 (September 3, 2002)
	- Japanese localization by Kaori Saegusa (http://homepage.mac.com/bitchvalley/)
	- Improved the way drawers in Cocoa applications are handled when a window is minimized.
	- Fixes a bug in Roxio Toast Titanium 5.1.4 that made it crash on startup with WindowShade X installed.
	- Rewrote sound playing system for better performance/memory utilization.
	- Improved custom window shadows performance.
	- Fixed a bug introduced in v2.1 causing system slowdowns.
	- Fixed a bug with desktop icons being affected by custom shadow settings.
	- Fixed a bug with incorrect drawer behavior while windowshading in Mail.app in Mac OS X 10.1.5.
	- Option-windowshade all windows is now working properly in applications with floating windows visible (Eudora, BBEdit and others).
	- A warning is given if the haxie was not activated properly.
	- Obligatory smaller bugfixes.

Version 2.1 (August 24, 2002)
	- WindowShade X is now compatible with Mac OS X 10.2.
	- Moved the haxie to our new Application Enhancer backend.
	- Fixed numerous bugs and optimized some code.

Version 2.0 (April 15, 2002)
	- This update is free for all registered users of WindowShade X 1.x (as usual).
	- Ability to minimize all windows by holding down Option while minimizing.
	- Ability to control MacOS X windows shadows parameters, such as density, location, spread and more.
	- New installer: install for current or all users, create installation logs and do Internet version checks prior to installing.
	- New option to play WindowShade X default sounds, ignoring installed Xounds.
	- Excluded Applications option to disable WindowShade X for specific applications.
	- WindowShade X will limitedly support Java applications - it is possible to collapse a Java application window, but it will uncollapse if you will drag it. We are working on a fix.
	- Added an option to subscribe to our low-traffic haxies announce mailing list from within the preference pane.
	- Numerous bugfixes and code optimizations.

Version 1.5.1 (February 28, 2002)
	- Fixed a potential compatibility issue with 3rd party system enhancing utilities (Default Folder X, MaxMenus).
	- Startup Items check is smarter, will automatically fix entries pointing to an older version of WindowShade X.
	- Fixed a bug causing crashes in ProjectBuilder when launching Carbon applications from it.
	- Some other bugfixes and tweaks.

Version 1.5 (December 17, 2001)
	- Individual application settings - you can now choose different behaviors on per-application basis.
	- New minimization behavior for Cmd-M key combination.
	- New behavior to do nothing (ignore action).
	- Substantial code cleanups and optimizations.
	- New small icon for the Preference Pane.
	- Fixed a bug with incorrect behavior with some Cocoa applications while minimizing (most often OmniWeb and Calculator).
	- Fixed a bug with registration information not being accepted.
	- Cocoa shading uses better algorithm of detecting windows.

Version 1.1 (October 25, 2001)
	- Cocoa WindowShade.
	- Selectable behaviors for double-clicking in the title bar, minimize button and control-double-clicking.
	- Visual feedback when choosing opacity.
	- Uninstall options for the Installer.
	- Demo period extended from 30 minutes to one hour.
	- Wrong minimization for some Carbon applications for WindowShade minimization style (most commonly seen in Microsoft Internet Explorer and Office v.X betas).
	- Other small bugfixes through all the code.

Version 1.0 (October 18, 2001)
	- Initial release.

Distribution And License Agreement

WindowShade X is not free. Until you purchase it, it runs in demo mode. The demo version has no features removed, but will function only 15 days after installation. In order to enable the full version, you will need to purchase WindowShade X. To do so, go to this URL:

http://www.unsanity.com/goto/buy-wsx/

WindowShade X is priced at US $10.00. Volume discounts and site licenses are available at our online store.

WINDOWSHADE X ("THE SOFTWARE") IS PROVIDED AS IS. USE THE SOFTWARE AT YOUR OWN RISK. UNSANITY LLC ("THE AUTHOR") MAKES NO WARRANTIES AS TO PERFORMANCE, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR ANY OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED. NO ORAL OR WRITTEN COMMUNICATION FROM OR INFORMATION PROVIDED BY THE AUTHOR SHALL CREATE A WARRANTY. UNDER NO CIRCUMSTANCES SHALL THE AUTHOR BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE, MISUSE, OR INABILITY TO USE THE SOFTWARE, EVEN IF THE AUTHOR HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. THESE EXCLUSIONS AND LIMITATIONS MAY NOT APPLY IN ALL JURISDICTIONS. YOU MAY HAVE ADDITIONAL RIGHTS AND SOME OF THESE LIMITATIONS MAY NOT APPLY TO YOU. DISTRIBUTING PRIVATE REGISTRATION INFORMATION FOR THE PRODUCT IS CONSIDERED A VIOLATION OF THIS AGREEMENT AND THE AUTHOR RESERVES THE RIGHT TO DISABLE THE REGISTRATION CODE AND/OR TAKE APPROPRIATE LEGAL ACTION.

Contacting Unsanity

	You can always get the latest versions of our products, news, FAQ, and updates at Unsanity's Web Site:

http://www.unsanity.com/
	
	To jump directly to the Haxies page, you can use this simple address:

http://www.haxies.com/

	To get support on WindowShade X, either visit the online support database at:

http://www.unsanity.com/support/

	or email us at: 
support@unsanity.com

	To submit an idea or suggestion for this or future haxie, use this address:

feedback@unsanity.com

¨

WindowShade X is Copyright ©2001-2005, Unsanity, LLC.
Haxie, Unsanity and WindowShade X are  trademarks of Unsanity, LLC.
All other trademarks are property of their respective owners.
http://www.unsanity.com/